home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 10 / The PC-Sig Library - Shareware for the IBM PC and Compatibles (PC-SIG)(Tenth Edition Disks 1-2804)(1991).iso / PC_SIGCD / 04 / 4 / DISK0442.ZIP / READ.ME < prev    next >
Text File  |  1988-11-30  |  5KB  |  94 lines
  1. SPA:WN (Structured Programming Automated: Warnier Notation) is being
  2. distributed in the free-ware mode.  We are not attempting to copy
  3. protect it or to limit its distribution by any sales agreement.  We do
  4. ask that if you use the program in any productive activity that you send
  5. money (we suggest $50.00 per user machine, but more or less is welcome) to:
  6.  
  7.       Kansas State University Research Foundation
  8.       1640 Fairchild Avenue
  9.       Manhattan, KS  66502
  10.  
  11. You'll be supporting research in a deserving and not very rich
  12. institution as well as providing recompense for a fairly long
  13. development process.  You may copy this distribution disk for other
  14. interested persons, but be sure to include this file.  If you wish to
  15. enhance this product or incorporate it into another product for sale,
  16. make suitable arrangements with the Research Foundation.
  17.  
  18. The documentation file (SPAWN.DOC) appears on this diskette.  It
  19. represents a synthesis of different attempts to explain what SPA:WN is
  20. all about to different user audiences.  The first part is for people
  21. unfamiliar with the concepts of structured programming and hierarchical
  22. top-down design.  Its purpose is to set the context for the use of
  23. SPA:WN and to explain the advantages of the use of structured constructs
  24. in program development.  The next parts concentrate mostly on the
  25. mechanics of the input stream construction, and give an overview of the
  26. development cycle from program conception through coding to long term
  27. maintenance, and provide a few examples of routine applications of SPAWN
  28. for program design and development.  Finally, more advanced details
  29. which may be required in various specialized or unusual enviroments are
  30. outlined in the final sections of the document.
  31.  
  32. From the documentation file, you should be in a position to make
  33. effective use of the SPA:WN system.  The SUMMARY.USE file won't make
  34. much sense until the longer description is read.  In addition to this
  35. diskette, you'll need a printer and enough memory and disk space to meet
  36. the program's requirements.
  37.  
  38. Three different forms of the PWARN (for PASCAL WARNIER) program are
  39. provided.  The .COM file is executable code.  The .PAS file is Turbo
  40. PASCAL source code employed to produce the .COM file.  The .WAR file is
  41. the source code for the program in the form of SPA:WN input.  If you
  42. 'SPAWN PWARN' the *.PUN file will (almost) be the PWARN.PAS file.  [The
  43. comments (8*...*8) surround code fragments to be excluded for Turbo
  44. PASCAL and included for PASCAL 8000, and the comments (T*...*T) surround
  45. code fragments to be included for Turbo PASCAL and excluded for PASCAL
  46. 8000.  Proper enabling/disabling (e.g. by global edit commands) of these
  47. fragments produce exactly PWARN.PAS or its PASCAL 8000 counterpart.]
  48.  
  49. The SPAWN.BAT file facilitates the execution of the program.  It is
  50. invoked by issuing 'SPAWN filename' where filename is the name of a file
  51. (extension must be .WAR) which is an input stream constructed for
  52. SPA:WN.  This batch file defines the set of output files (.ECH for the
  53. echo and diagnostic, .DIA for the diagram, .PUN for any target language
  54. source code, and .SRC for any reordered SPA:WN input).  A CLEANUP.BAT
  55. file is provided to erase this same set of output files.  Invoke it with
  56. 'CLEANUP filename'.
  57.  
  58. The RODGERS.WAR is an example input file, syntactically correct in the
  59. view of SPA:WN, which may be useful in practicing the use of the SPAWN
  60. command and observing its results.  The FORTRAN program produced from
  61. RODGERS has never been compiled, so you may find horrible FORTRAN errors
  62. in it. 'SPAWN RODGERS' runs in a 256K machine with 120K of free disk
  63. space.
  64.  
  65. Running 'SPAWN PWARN' will fail (as provided) if you employ a 360K
  66. floppy disk -- the total volume of the output files exceeds 360K.  This
  67. could be repaired by editing SPAWN.BAT to direct files to different
  68. disks. 'SPAWN PWARN' runs all right (as delivered) using a hard disk
  69. system with 600K or so of free space.  [PWARN has a number of constants
  70. defined which could be changed to alter output page dimensions.
  71. However, there has been little or no testing of alternative parameter
  72. combinations, and there can be no guarantee that you will succeed in
  73. attempts to redefine the output page dimensions of Warnier diagrams.]
  74.  
  75. The size of Warnier diagram which can be run depends upon the amount of
  76. memory in your computer system.  The entire diagram is held in memory
  77. while PWARN runs, so very large diagrams cannot be run in systems with
  78. small memories. 'SPAWN PWARN' runs for sure in 512K and smaller diagrams
  79. (like RODGERS.WAR) run in 256K machines.  We don't know the details of
  80. the function of space requirement vs. diagram size, or the minimum
  81. machine size to run 'SPAWN PWARN'.  It is good practice to keep your
  82. Warnier diagrams small, so any memory limitations should be gratefully
  83. accepted as a sign that your diagrams should be subdivided.
  84.  
  85. Information about bugs and other comments may be sent to:
  86.  
  87.      Kenneth Conrow, Manager, User Services
  88.      University Computing Facilities
  89.      Cardwell Hall
  90.      Kansas State University
  91.      Manhattan, KS  66506         (913)532-6311
  92.  
  93.  
  94.